Release 10.1A: OpenEdge Development:
ADM Reference

dataAvailable

Event procedure that handles changes to dataSource data, a record position, or a change to the data or record position of this object. Changes are handled by assigning a new value to the ForeignFields property, reopening the query, resetting QueryPosition, and republishing the event.

Location: data.p

Parameters:

INPUT pcRelative AS CHARACTER

Provides information about a new or changed record. Valid entries are:

SAME — Performs a RETURN only because the new record is the same as the current record.
RESET — Resets the status and foreign fields, and refreshes visual objects and panels for all objects that are part of the data link. This option provides more functionality than SAME and less functionality that DIFFERENT. Use this option when you want to send notification about a change in the RowObject record without having to reopen all the dependent queries.
VALUE–CHANGED — Indicates that the data target has changed position. However, ensures that the query is not reopened but published as DIFFERENT from from this point so the data targets for this object are opened.
DIFFERENT — Reapply Foreign Fields values except when called from a dataTarget. It that instance, handle as VALUE-CHANGED.
FIRST, NEXT, PREV, LAST, REPOSITIONED — Handle the same as DIFFERENT in this version of dataAvailable.
TRANSFER — Joins the child data object to the current record in a parent data object. As a result, the call only needs to be performed in the parent data object inside of a container.
Notes: The dataTarget passes VALUE-CHANGED to indicate a change that does not require the value for Foreign Fields be reapplied. As a result, the source for dataAvailable does not need to be checked, and this procedure provides support for SmartBusinessObjects (SBOs) as dataSources.